home *** CD-ROM | disk | FTP | other *** search
/ PD Collection CD 1 / PD Collection CD 1.iso / textual / gnudiff / Man / Diff,1 next >
Text File  |  1991-04-24  |  5KB  |  120 lines
  1.  
  2.  
  3.  
  4.      diff(1)                                                      diff(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           diff - differential file comparator
  10.  
  11.      SYNOPSIS
  12.           diff [ -efbh ] file1 file2
  13.  
  14.      DESCRIPTION
  15.           Diff tells what lines must be changed in two files to bring
  16.           them into agreement.  If file1 (file2) is -, the standard input
  17.           is used.  If file1 (file2) is a directory, then a file in that
  18.           directory with the name file2 (file1) is used.  The normal
  19.           output consists of a series of commands; each command is
  20.           followed by the lines it affects. The commands tell how to turn
  21.           file1 into file2.  Just as in ed, arguments to the commands are
  22.           numbers; either a single number for num or a pair of numbers
  23.           separated by a comma (no spaces) for range (see the commands,
  24.           below). A range that refers to a single line appears as a
  25.           single number.  The lines from file1 are prepended with <; from
  26.           file2, with >.
  27.  
  28.           The commands resemble ed commands:
  29.  
  30.           num a range       Append the range of lines from file2 after
  31.                             line num in file1.
  32.  
  33.           range d num       Delete the range of lines in file1.  Num
  34.                             points to the line in file2 last compared
  35.                             before the d command was triggered.
  36.  
  37.           range1 c range2   Change. Replace range1 in file1 with range2
  38.                             in file2.  In the output, both ranges of
  39.                             lines appear after this command, one range at
  40.                             a time, separated by a short line (___).
  41.  
  42.           The commands tell how to convert file1 into file2; however, by
  43.           exchanging a for d and reading backward, you can tell how to
  44.           convert file2 into file1.
  45.  
  46.           Diff may appear to refer to lines that aren't there, especially
  47.           lines at the end of the file. It believes that trailing blank
  48.           lines are as significant as text.
  49.  
  50.           Options are:
  51.  
  52.           -b      Ignores trailing blanks (spaces and tabs) and compares
  53.                   other strings of blanks as equal.
  54.  
  55.           -e      Produces a script of a, c, and d commands for the
  56.                   editor ed.  If run through ed, they will turn file1
  57.                   into file2 (see "EXAMPLES").
  58.  
  59.           -f      Produces a script in the same format that -e does, but
  60.                   in reverse order. The script would not be meaningful to
  61.                   ed, however.
  62.  
  63.           -h      Causes diff to do a fast, half-hearted job. Ranges of
  64.                   nonidentical text are resolved with giant change
  65.                   commands rather than a series of more precise append,
  66.                   change, and delete commands.  It works only when
  67.                   changed stretches are short and well separated, but
  68.                   does work on files of unlimited length.  Options -e and
  69.                   -f cannot be used with -h.
  70.  
  71.           Except in rare circumstances, diff finds a smallest sufficient
  72.           set of file differences.
  73.  
  74.  
  75.      EXAMPLES
  76.           $ diff file1 file2
  77.  
  78.           9a10
  79.           >file2
  80.  
  81.           The above example shows that the only difference between file1
  82.           and file2 is line 10 of file2.  The output from the diff
  83.           command states that to make file1 the same as file2, line 10
  84.           from file2 should be appended to file1 after line 9.  The line
  85.           that should be appended is shown on the second output line.
  86.           The string "file2" should be inserted after line 9 of file1 to
  87.           make file1 and file2 the same.
  88.  
  89.           $  diff -e file1 file2 > ed_script_file
  90.           $ ( cat ed_script_file ; echo '1, $p' ) | ed - file1.new
  91.  
  92.           $
  93.  
  94.           The above example compares the two files, produces an ed script
  95.           to turn file1 into file2, and displays the results on the
  96.           screen.  NOTE:  The only commands that will be part of the
  97.           script file are a, c, and d commands.
  98.  
  99.      FILES
  100.           possible temporary file /tmp/d?????
  101.           /usr/lib/diffh for -h
  102.  
  103.      SEE ALSO
  104.           cmp(1), comm(1), diff3(1), diffmk(1), ed(1).
  105.  
  106.      DIAGNOSTICS
  107.           Exit status is 0 for no differences, 1 for some differences, 2
  108.           for trouble.
  109.  
  110.      BUGS
  111.           Editing scripts produced under the -e or -f option are naive
  112.           about creating lines consisting of a single period (.).
  113.  
  114.      WARNINGS
  115.           Missing newline at end of file X
  116.                indicates that the last line of file X did not have a
  117.                new-line.  If the lines are different, they will be
  118.                flagged and output, although the output will seem to
  119.                indicate they are the same.
  120.